NetCloak 3.0 Pro User's Guide: Dynamic Pages: Pro Commands

	Version 3.0 Pro User's Guide

Dynamic Pages: Pro Commands	Previous \| Next Contents

NetCloak Pro supports additional commands and options for use in "cloaking" HTML pages, beyond those commands described in the NetCloak Standard User's Guide. This section describes those additional commands and options.

Pro Commands: NetCloak Configuration

Additional NETCLOAK Configuration Options

The SET_NETCLOAK, NETCLOAK, SHOW_NETCLOAK, HIDE_NETCLOAK, and INSERT_NETCLOAK commands (described in the NetCloak Standard User's Guide) are used to set or display NetCloak configuration settings in an HTML page, or show or hide parts of an HTML page based on those settings.

The NetCloak Standard User's Guide describes the configuration settings available in the Standard edition of NetCloak. Because it contains additional configuration settings for processing forms via FDML files, NetCloak Pro supports additional configuration parameters in the SET_NETCLOAK and NETCLOAK commands.

In particular, these additional parameters are most useful because SET_NETCLOAK and NETCLOAK commands can be added to FDML files, to modify configuration options for an individual form submission.

These additional configuration settings and the valid options for each setting are described below.

DuplicateFiles

Tells NetCloak Pro what to do when creating files via a CREATEDOC directive, and an existing file with the same name in the same folder already exists. Valid options for this setting are:

Overwrite	Always overwrite the existing file with the newly-created file.
Unique	Never overwrite the existing file; instead, a new file with a unique filename is created. The filename consists of the original filename with two alphanumeric characters appended to it.
Smart	Use "smart resubmit"; this means that the existing file will only be overwritten if it is less than 15 minutes old, and was submitted by the same user (IP address).

ConvertBrackets

This allows you to determine how NetCloak Pro will handle angle bracket characters in form field data when they are inserted into the resulting page. Options for this setting:

True	Convert angle bracket characters to the corresponding "<" and ">" HTML entities.
False	Do not convert angle bracket characters. If you want to allow users to include HTML commands in submitted form fields, use this setting.

NewFileTranslation

Tell NetCloak Pro what character translation to perform, if any, when creating new files with a CREATEDOC directive. The options for use with this setting are:

None	Perform no character conversions.
MacRoman	Convert "extended" ASCII characters (with ASCII values greater than 128) from the ISO-8859-1 (ISO-Latin-1) character set to the standard MacRoman character set, so that the file is in a standard Macintosh text format. When such characters are viewed in a Macintosh text application, they will appear as the expected Mac extended characters (the apple symbol, the bullet symbol, etc.). When viewed in a web browser, however, unexpected "garbage characters" may appear-particularly if the browser is running on something other than the Mac OS.
Entities	When this option is selected, extended characters in the form data are converted into the HTML-defined "entity" codes (such as " "), so that they appear correctly in HTML documents viewed in any Web browser.

LinkNextText

Defines the text displayed in the hypertext link created by the <LINKNEXT> tag in created documents. The value of this configuration setting can by any string of text not including double-quote characters.

LinkPrevText

Defines the text displayed in the hypertext link created by the <LINKPREVIOUS> tag in created documents. The value of this configuration setting can by any string of text that does not include double-quote characters.

Pro Commands: Utility

<EXEC_FDML FDMLPath beginText endText>

Using this command in any HTML page, NetCloak Pro can trigger the processing of an FDML file whenever a Web page is accessed by a browser. Multiple instances of this command in a cloaked page can also be used to perform multiple tasks from a single form submission, without using CHAIN directives.

Where this command appears in the page, NetCloak Pro will insert the response page returned from the FDML file.

The FDMLPath parameter is a filepath to an FDML file. This parameter conforms to the filepath rules described in the NetCloak Standard User's Guide; if the path begins with a slash or colon character, the path is appended to the Root Folder to locate the file. Otherwise, the path is appended to the path of the folder in which the page containing the EXEC_FDML command resides.

The optional "beginText" and "endText" parameters are used to extract only a portion of the response page to be inserted into the HTML page. If omitted, NetCloak will use "<BODY>" and "</BODY>" so that only the content of the response page body is inserted into the cloaked HTML page.

Here are some examples:

    <EXEC_FDML "SendMsg.fdml">

This command processes the FDML file "SendMsg.fdml", located in the same folder as the current page, and inserts the body of the resulting response page into the current page.

    <EXEC_FDML "/forms/updaterpt.fdml">    <EXEC_FDML "/forms/log.fdml" "</HEAD>" "<BODY>">

This example causes two FDML files to be executed; the files named "updaterpt.fdml" and "log.fdml", each located in the "forms" folder in the Web server Root Folder. The response from processing "updaterpt.fdml" will be inserted into the HTML page. Because no text usually occurs between the </HEAD> and <BODY> tags in an HTML page, no text from the response of the second FDML file will be inserted into the final page.


Copyright © 1996-1999 Maxum Development Corporation http://www.maxum.com/	Previous \| Next Contents